home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / text / print / ghostscript2_6_1.readme < prev    next >
Text File  |  1993-07-28  |  12KB  |  281 lines
  1. Short: Port of Ghostscript 2.6.1
  2. Author: Olaf Barthel <olsen@sourcery.han.de>
  3. Uploader: Stefan Becker <stefanb@pool.informatik.rwth-aachen.de>
  4.  
  5. GNU Ghostscript 2.6.1 Amiga port
  6. ================================
  7. This port requires:
  8.  
  9. - An  Amiga  equipped  with  an  '020  CPU and an '881 FPU or any successor
  10.   CPU/FPU model and Kickstart 2.04 or higher.
  11.  
  12. - Approx. 4.7 MBytes of hard disk space available.
  13.  
  14. - A  minimum  of 1 MByte of chip memory, depending on what you will want to
  15.   do  with  the  interpreter.  Printer output requires at least 2 MBytes of
  16.   contiguous memory (any memory, not necessarily chip memory).
  17.  
  18. - ixemul.library and a bunch of Postscript/Ghostscript fonts.
  19.  
  20.  
  21. New Amiga features in this release
  22. ----------------------------------
  23. The  v2.6.0 port used to implement only monochrome drivers, the v2.6.1 port
  24. supports  colour  output on most devices, exceptions where noted. You don't
  25. need  a  special  brand  of graphics hardware expansion, colour output will
  26. work  on  any  Amiga  model, provided there is enough memory available. All
  27. devices capable of doing colour output will reduce the number of colours to
  28. be displayed if in dire need of memory. As for the display oriented devices
  29. this will go mostly unnoticed as the Ghostscript halftoning algorithms will
  30. compensate  for  any  colour reductions. However, printer output quality is
  31. very likely to suffer from colour reduction. So, watch out!
  32.    As  the display oriented devices start up in colour output mode, black &
  33. white  rendering  may  be slightly slowed. The printer device is configured
  34. according  to  the  Preferences  settings;  `Black  & white' will result in
  35. monochrome  output,  `Grayscale  1'  and  `Grayscale  2'  will also produce
  36. monochrome  output  but will internally use a true colour representation of
  37. the  page,  so  does  `Color'. Please note that `true colour' refers to the
  38. Amiga  12  bit colour model, at this time of writing 24 bit colour printing
  39. is not yet implemented.
  40.    The  default  output  device  (a  super-bitmap  window  to opened on the
  41. default  public  screen,  such  as  Workbench)  will  take advantage of the
  42. Kickstart  3.0  pen  sharing  feature  if  enough  colours  (eight or more)
  43. available.
  44.  
  45. The v2.6.0 port used to rely on printer drivers to initialize their maximum
  46. page  size  information  upon startup. Several users reported problems with
  47. certain  drivers  which  would  make  this information available only after
  48. having  been  asked  to do so. The v2.6.1 port now follows the programmers'
  49. guidelines  how  to determine the maximum page size closely. The driver may
  50. still  complain  if  configured for `Grayscale 1', `Grayscale 2' or `Color'
  51. output  and  there  is  not  enough  memory  available  for  the page to be
  52. displayed.
  53.  
  54.  
  55. Installation
  56. ------------
  57. Enter  the  command  line interpreter, Create a directory on your hard disk
  58. drive,  label  it "ghostscript". Let's assume that the fully qualified name
  59. of  this  directory  will  be  "Work:ghostscript". Enter this directory and
  60. unpack  the  archives  "gs-2.6.1-amiga.lha"  and "gs-2.6.1-fonts.lha". This
  61. will  create  the  directory "Fonts" which holds all Ghostscript fonts, the
  62. directory  "doc"  which  contains  the Ghostscript documentation files, the
  63. directory "examples" which is to hold some Postscript example files and the
  64. directory   "libs"   which   contains   `ixemul.library'.   Now  edit  your
  65. `S:User-Startup' file, adding the following lines:
  66.  
  67.    Assign ghostscript: "Work:ghostscript"
  68.    Path ghostscript: add
  69.    Assign Libs: ghostscript:libs add
  70.  
  71. Save the file back to disk and reboot your machine.
  72.  
  73.  
  74. Running the interpreter
  75. -----------------------
  76. Enter  the  command  line  interpreter,  type  "gs"  and  press return. The
  77. interpreter   will  be  loaded  and  will  try  to  initialize  itself.  If
  78. successfully initialized, a window should have been opened on the Workbench
  79. screen. The Shell window now should display the following text:
  80.  
  81.    Initializing... done.
  82.    Ghostscript 2.6.1 (5/28/93)
  83.    Copyright (C) 1990-1993 Aladdin Enterprises, Menlo Park, CA.
  84.      All rights reserved.
  85.    Ghostscript comes with NO WARRANTY: see the file COPYING for details.
  86.    GS>
  87.  
  88. At  the  command  prompt,  enter "(ghostscript:examples/golfer.ps) run" and
  89. press  return.  Click  on  the `Zoom' button in the top right corner of the
  90. window  to  bring it to full screen size, move the scrollers and watch what
  91. will  happen. When rendering is finished, the Shell window will display the
  92. following text:
  93.  
  94.    >>showpage, press <return> to continue<<
  95.  
  96. Press  return  to  erase  the  contents  of the window and to continue. The
  97. interpreter  will  be  in  interactive  mode  again, enter "quit" and press
  98. return to end this session.
  99.  
  100. For  more  information  refer to the documentation in the "ghostscript:doc"
  101. drawer.
  102.  
  103.  
  104. How to print a document
  105. -----------------------
  106. As the corresponding Ghostscript device will always keep the entire page in
  107. memory  the  printer need not be capable of strip-printing. The bad news is
  108. that  the  entire page will consume *a lot* of memory. This Amiga port will
  109. keep  the page in any public memory area, so it will not necessarily eat up
  110. precious chip memory. This should make it possible to print pages on Amigas
  111. with  only  1  MByte of chip memory or less, provided enough fast memory is
  112. available.
  113.  
  114. Enter  the  command  line interpreter, type "gs -sDEVICE=amiga_printer" and
  115. press  return.  This  will  invoke  the  Ghostscript  interpreter  with the
  116. "amiga_printer"  device  driver  selected  as  the startup device. When the
  117. command prompt appears, enter "(ghostscript:examples/butterfly.ps) run" and
  118. press return. The rendered image will be sent to the printer. When printing
  119. is finished, press return and enter "quit" to end this session.
  120.  
  121. Note:  unless you want Ghostscript to prompt you to press return after each
  122. page  is  printed and ejected you should include "-dNOPAUSE" on the command
  123. line.
  124.  
  125.  
  126. Available device drivers
  127. ------------------------
  128. This port implements the following seven device drivers:
  129.  
  130.    amiga
  131.  
  132.       (This is the default output device)
  133.  
  134.       Rendering  takes  place  in a super-bitmap window to be opened on the
  135.       Workbench  screen.  This  window  contains  scroller  handles to move
  136.       around in the bitmap. Usually, the bitmap will be four times as large
  137.       as the screen the window opens upon.
  138.  
  139.    amiga_low
  140.  
  141.       Renders into a low-resolution custom screen.
  142.  
  143.    amiga_high
  144.  
  145.       Renders into a high-resolution custom screen.
  146.  
  147.    amiga_super
  148.  
  149.       Renders into a super-high-resolution custom screen.
  150.  
  151.    amiga_a2024¹
  152.  
  153.       Renders into an A2024 resolution custom screen.
  154.  
  155.    amiga_printer
  156.  
  157.       Outputs  pages  on  the  currently  configured  preferences  printer.
  158.       Respects density and resolution settings. Requires a lot of memory to
  159.       run.
  160.  
  161.    amiga_ilbm¹
  162.  
  163.       Will prompt for a file name to save the current page contents to. The
  164.       page  will  be  saved  as  a standard IFF-ILBM picture, including DPI
  165.       information,   suitable   for  postprocessing  using  standard  image
  166.       processing and editing software.
  167.  
  168.  
  169.    ¹) Monochrome output only
  170.  
  171.  
  172. Properties
  173. ----------
  174. With  Ghostscript  2.6.1 one can specify several driver specific options on
  175. the  command  line.  As  for  the Amiga drivers, they support the following
  176. properties:
  177.  
  178. - PageWidth and PageHeight
  179.  
  180.   The  dimensions  of  the  page  to  render  into.  The physical page size
  181.   Ghostscript  will  use  for  rendering is limited by these dimensions. On
  182.   startup  The Amiga drivers will default to a page size roughly equivalent
  183.   to A4 unless different dimensions are specified. The size definitions may
  184.   include  measuring  units  (e.g. "-sPageWidth=21cm"), the following units
  185.   are  supported: pt (points, the default if no unit is given), pc (picas),
  186.   in  (inches),  cm  (centimeters), mm (millimeters), dd (didot points), cc
  187.   (ciceros).
  188.  
  189. - OutputFile
  190.  
  191.   The  amiga_ilbm device pays attention to this property, which it will use
  192.   to  construct  the  output  file  names for pages to be saved with. Thus,
  193.   `-sOutputFile="ram:page"'    yields    the   files   "ram:page0001.ilbm",
  194.   "ram:page0002.ilbm", etc.
  195.  
  196.  
  197. Not all devices will pay attention to DPI page resolutions.
  198.  
  199.  
  200. Installing fonts
  201. ----------------
  202. The   Ghostscript  distribution  includes  a  number  of  public-domain  or
  203. otherwise  freely  distributable  fonts.  However, these are mostly of poor
  204. quality.  In  order  to  install  a  new  font  or to replace a font with a
  205. different one, the following steps are required:
  206.  
  207. 1. The  font  must  be  converted  to  Ghostscript format. For font files in
  208.    BDF-format  (such  as  the  fonts included in the X-Windows distribution)
  209.    this  requires  processing  with  the  "bdftops"  script  file (syntax is
  210.    "bdftops <Source file> <Destination file>"). Fonts in standard ASCII text
  211.    format (".PFA" format) or packed binary file format (".PFB" format), such
  212.    as  most  Adobe-Type-1  hinted outline fonts to be purchased from various
  213.    vendors, need  not  be converted as this is the native format Ghostscript
  214.    expects.
  215.  
  216. 2. Copy  the resulting output file to the "ghostscript:fonts" drawer, choose
  217.    a   suitable   name   (see   the   file  "ghostscript:fontmap"  for  more
  218.    information).
  219.  
  220. 3. Edit  the  file "ghostscript:fontmap" to include the font which will make
  221.    it visible to the interpreter. Read this file carefully as it gives basic
  222.    hints  how  to  name  a  font file and how to edit the corresponding font
  223.    entry.
  224.  
  225.  
  226. The Workbench window
  227. --------------------
  228. The  default output device (the Workbench window) can be controlled both by
  229. mouse and by keyboard:
  230.  
  231.    Cursor  keys  will  move the currently visible area of the page, holding
  232.    down  a  Shift  or  Control  key will increase the size of the scrolling
  233.    steps.
  234.  
  235.    Control+C  and  Escape  will  send the interpreter a signal to terminate
  236.    processing, so does clicking the window close button.
  237.  
  238. By  default  the  page  size  will  always  be  four  times as large as the
  239. currently visible portion of the Workbench screen, see the section entitled
  240. "Page sizes and resolutions" for more information.
  241.  
  242.  
  243. Troubleshooting
  244. ---------------
  245. This  interpreter  implementation  requires a lot of chip memory to run. In
  246. order  to  assure that enough memory will be available, close any Workbench
  247. drawers  or  Shell  windows  which  are  not necessarily require to run the
  248. interpreter.
  249.  
  250. Most  Postscript  documents  use  hard-coded  document page sizes, i.e. the
  251. output  page  size  will not be scaled to fit the currently set output page
  252. size.  In  these  cases  you may want to make use of the Postscript "scale"
  253. operator. Say, you wish to preview the file "butterfly.ps" in just half its
  254. size.  Enter  "0.5  dup  scale" and press return, now enter "(butterfly.ps)
  255. run"  and  press return; et voilà: the butterfly will be rendered just half
  256. as large as usual.
  257.  
  258. Some  documents,  such  as  "porsche.ps",  contain no "showpage" command to
  259. finish  the  batch  job.  In this case, type "showpage" and press return or
  260. enter "erasepage" and press return to clear the page.
  261.  
  262.  
  263. About the Amiga port
  264. --------------------
  265. This  port  is  based  on  Ghostscript  2.6.1. It was implemented using GCC
  266. 2.3.3,  so  you  will  have  to refer to the file "COPYING" for copying and
  267. licensing information.
  268.  
  269.                       This Amiga port was created by:
  270.  
  271.                            Olaf `Olsen' Barthel
  272.                              Brabeckstrasse 35
  273.                              D-30559 Hannover
  274.  
  275.                         Federal Republic of Germany
  276.  
  277.                        eMail: olsen@sourcery.han.de
  278.                               o.barthel@a-link-h.comlink.de
  279.  
  280. The source code is included in the "amiga-src" drawer.
  281.